SerpBear
Search
K

Deploying SerpBear on a Server

Getting up and running on a server takes only a few minutes. Once you have logged in using SSH, follow these steps to get it up and running on an Ubuntu server.
Step 1:
Install Docker using this tutorial.
Step 2:
Install Docker Compose by running the following commands:
# Install Docker Compose
mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/download/v2.2.3/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
chmod +x ~/.docker/cli-plugins/docker-compose
sudo chown $USER /var/run/docker.sock
# Verify that Docker Compose is installed
docker compose version
Step 2:
Install Nginx and connect your domain to your Server
  1. 1.
    First, install Nginx
sudo apt install nginx
2. Then open the default site config file
sudo nano /etc/nginx/sites-available/default
3. Remove everything inside the location brackets and add proxies. Note: if localhost does not work use ip address from your droplet.
location / {
proxy_pass <http://localhost:3000>;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
  1. 1.
    Above the location we have server_name_;. Set the server name to your domain name if you want to use a domain name for this app. It should look like this: server_name serpbear.mydomain.com Exit and save: Ctrl+X & Y
  2. 2.
    Check so nginx is configured properly sudo nginx -t It should say something like the test is successful
  3. 3.
    Now restart the service sudo service nginx restart
Step 3
Add SSL for your domain following these commands
sudo snap install core; sudo snap refresh core
sudo apt-get remove certbot
sudo snap install --classic certbot
sudo certbot --nginx -d serpbear.mydomain.com
sudo certbot renew --dry-run
Step 4:
Enable Firewall:
ufw enable
ufw allow ssh
sudo ufw allow 'Nginx Full'
Step 5:
Create a new directory called serpbear and create a docker-compose.yaml file with the following content:
version: "3.8"
services:
app:
image: towfiqi/serpbear
restart: unless-stopped
ports:
- 3000:3000
environment:
- USER=admin
- PASSWORD=0123456789
- SECRET=4715aed3216f7b0a38e6b534a958362654e96d10fbc04700770d572af3dce43625dd
- APIKEY=5saedXklbslhnapihe2pihp3pih4fdnakhjwq5
- NEXT_PUBLIC_APP_URL=http://localhost:3000
volumes:
- serpbear_appdata:/app/data
networks:
my-network:
driver: bridge
volumes:
serpbear_appdata:
Change Environment Variables to your needs. The Details of the Environment Variables can be found here.
Step 6:
From the same directory, run the container using the following Command:
docker compose up

Updating the App

When there is a new version, and you want to update your instance of the app, navigate to the serpbear directory and run the following:
docker compose pull
docker compose up