Basic server configuration
This is the bare minimum configuration required for the server to be reasonably useful.
Obtain server's IP address
The Obico Server needs to have an IP address that is accessible by OctoPrint or Klipper. It can be an private IP address (192.168.x.y, etc) but there needs to be a route between OctoPrint and the Obico Server.
Login as Django admin
- Open Django admin page at
Note: If the browser complains "Can't connect to the server", wait for a couple more minutes. The web server container may still be starting up.
- Login with username
supersecret. Once logged in, you can optionally (but highly encouraged to) change the admin password using this link:
Configure Django site
In the same browser window, go to the address
http://your_server_ip:3334/admin/sites/site/1/change/. Change "Domain name" to
your_server_ip:3334. No "http://", "https://" prefix or trailing "/", otherwise it will NOT work. Note: Deleting the original site and adding a new one won't work, thanks to the quirkiness of Django site.
Click "Save". Yes it's correct that Django is not as smart as most people think. ;)
Note: If you are using reverse proxy, "Domain name" needs to be set to
reverse_proxy_ip:reverse_proxy_port. See using a reverse proxy for details.
The following is using gmail as an example. Other web mail services may vary slightly, such as EMAIL_PORT
obico-serverdirectory, make a copy of
dotenv.exampleand rename the copy as
.envusing your favorite editor.
Find the following lines, and set them to the correct values of your email account:
EMAIL_HOST="your_email_host_here" # Such as "smtp.gmail.com"
EMAIL_HOST_USER="your_email_user_here" # Such as your email address for a Gmail account
EMAIL_HOST_PASSWORD="your_email_password_here" # Your email account password
EMAIL_PORT=587 # Check with your email provider to make sure. DO NOT surround it with quotes. Otherwise email won't be sent!
EMAIL_USE_TLS="True" # Set it to 'False' if your email provider doesn't use TLS, which is uncommon
- Restart the server
docker-compose up --build -d.
If you run into issues with Email server settings, please follow this Email server trouble-shooting guide.
Advanced server configuration
Ready for some advanced server chops? Feel free to dive into the advanced server stuff.
If you don't need to add a new environment variable
If you need to add a new environment variable