Common problems with Confluence
When you add the integration
| What you see | What to do |
|---|---|
wiki.example.com refused the credentials (401). Check the token, and that it has not expired. Fix the field above, or save anyway if the source is only unreachable for now. | The token is wrong or expired. Create a new one (step 1) and paste it as is in API token. |
No server answers to the name wiki.example.com. Check its spelling against the address you open in your browser. If it is right, Astrolabe cannot see this server: tell your company's Astrolabe administrator. Fix the field above, or save anyway if the source is only unreachable for now. | Copy the domain name from the address bar of your browser into Confluence host, without https://. |
In Administration
| What you see | What to do |
|---|---|
In Administration › Problems, a Company connection line wiki.example.com refuses the credentials (401). The token may be wrong or expired. (the State column of the Confluence card says wiki.example.com refused the credentials (401). Check the token, and that it has not expired.) | The token no longer works. Click Fix it, delete the token, and add a new one. |
In Administration › Problems, a Search line Confluence · <name> saying wiki.example.com answers, but no page was found to search. Check the space keys of the connection: a misspelled key finds nothing. | The keys in Spaces to search match no space. Click Fix it, compare each key with the address of its space (.../spaces/ENG/...), and correct the field. |
In Administration › Problems, a Search line Documentation · <component> saying The documentation could not be built from its repository, so it is not searched. Open it to read the error, and fix its mkdocs.yml or its pages. | The documentation of this component does not build, so the search cannot read it. Click Fix it: the documentation opens and shows the error. Correct the mkdocs.yml or the page it names. (Message taken from the screen's texts; not provoked on an instance.) |
In the search
| What you see | What to do |
|---|---|
| We couldn't find a match for a word you know is on a Confluence page | Open Filters and pick All under Kind. Otherwise the page is in a space outside Spaces to search, or was written less than half an hour ago. |
Still stuck?
Write to support@forgeit.fr with what you see on the screen.