Troubleshooting
Learn about how to solve common problems you might run into while using Shuttle.
This section is aimed at collecting common issues users have to provide quick debug solutions.
I've updated Shuttle and my project isn't working anymore.
I've updated Shuttle and my project isn't working anymore.
Make sure to follow all of the upgrading steps.
I get os error 2 when trying to load up my project
I get os error 2 when trying to load up my project
This is most likely to happen if you’re using one of our shared database annotations. To prevent this from happening, ensure that Docker is running.
Check Docker engines for more info.
libpq.so.5: cannot open shared object file
libpq.so.5: cannot open shared object file
I get mismatched dependencies between one of my dependencies and Shuttle crate dependencies!
I get mismatched dependencies between one of my dependencies and Shuttle crate dependencies!
This is likely because you are a using a different version of the dependency than the Shuttle crate, causing a dependency mismatch.
To fix this, there’s a couple of options:
- Switch the version of your crate over to the dependency. You can find the correct one either from the error itself, or going to Crates.io and checking the dependencies of the latest Shuttle crate version.
- If you are unable to do the above because of nested dependencies, you can typically fork the crate’s repo then upgrade the dependency yourself. However, depending on breaking changes this may be a non-trivial amount of work.
I get 401 Unauthorised error while trying to use the CLI
I get 401 Unauthorised error while trying to use the CLI
Other issues?
Hop on over to our Discord server, we are very responsive!