Overview: Support for Servas Docker Container

Application: Servas - https://github.com/beromir/Servas

Docker Hub: https://hub.docker.com/r/beromir/servas

GitHub: https://github.com/beromir/Servas

Documentation: https://github.com/beromir/Servas

 

For Any Non UnRaid related question please go to projects Home

This is not my project. I just created the template. All credits go to: Beromir

 

Description (from Dev):

A self-hosted bookmark management tool.
Servas is based on Laravel and Inertia.js and uses Tailwind CSS and Svelte for the frontend.

 

 

 

It still needs a lot of work but developer is active and available at github 

 

Requirements:
MySQL / Mariadb Database already running and available.
Create a User and DB for servas on your MySQL/Mariadb Instance.

Created config file (filename is : ".ENV" just a dot plus env ) and place inside servas config folder (/mnt/user/appdata/servas/) the content as follow:
 

APP_NAME=Servas
APP_ENV=production
APP_KEY=
APP_DEBUG=false
APP_URL=

DB_CONNECTION=mysql
DB_HOST=**** Enter IP/Hostname of mysql/mariadb ****
DB_PORT=3306
DB_DATABASE=**** name you assigned to servasdb ex. servasdb ****
DB_USERNAME=**** username allowed to access servasdb ****
DB_PASSWORD=**** password for user allowed to access servasdb ****

Once Container is running open the container console run the following 2 commands one at a time:

php artisan migrate

 

php artisan key:generate

 

Restart container and you should have acces to WebUI at port:8086
go to http://UnraidIP:8086/register to create a user.

 

Thank you very much for this template, love the service!

 

As a note, you could add all the required variables in the same template, so you won't need to edit the '.env' file. Also, it supports the use of Redis, which makes it faster.

Still Learning and appreciate the input. thank you

Hello, I see that the author of the docker container has added the ability to use SQLite as a data source. When you have a moment can you please update the UNRAID app to enable the builtin SQLite? Regards!

11 hours ago, burkesquires said:

Hello, I see that the author of the docker container has added the ability to use SQLite as a data source. When you have a moment can you please update the UNRAID app to enable the builtin SQLite? Regards!

Done. Template Updated.

 

@SmartPhoneLover Mention I can move the variables to the template. But you still need to created a physical file ".env" it stores the "APP_KEY=" and when running the required command:

In UnRaid Console : 

docker exec -it servas php artisan key:generate --force

 

or in the Container's Console: 

php artisan key:generate --force

 

If the .env local file doesn't exist it will fail to generate the APP_KEY and you will see "500 | Server Error" when accessing servas GUI.

 

So the at the very least the .env file must contain the line : APP_KEY=

 

If you want to keep using MYSQL/MariaDB

your .env file should look like this:

 

APP_KEY=

# MySQL
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=servas_db
DB_USERNAME=servas_db_user
DB_PASSWORD=password

 

Hi,

I think the default template is not properly configured. It creates the database in the container and is therefore wiped on update (Learned that the hard way... goodbye data).

As a walkaround I added a path mapping to the template like this:

Container Path: /var/www/html/database/sqlite/servas.db -> Host Path: /mnt/user/appdata/servas/servas.db

With that it survives an update and the data is actually stored in the appdata folder.

 

Maybe someone smarter than me can confirm, and maybe you will want to modify the template.

On 12/24/2023 at 4:02 AM, BlackShift said:

Hi,

I think the default template is not properly configured. It creates the database in the container and is therefore wiped on update (Learned that the hard way... goodbye data).

As a walkaround I added a path mapping to the template like this:

Container Path: /var/www/html/database/sqlite/servas.db -> Host Path: /mnt/user/appdata/servas/servas.db

With that it survives an update and the data is actually stored in the appdata folder.

 

Maybe someone smarter than me can confirm, and maybe you will want to modify the template.

Done. Template Updated.

Hi,

I'm using Servas with SQlite on Unraid and I'm very happy with it so far. A few days ago I updated to Version 0.5. Since then I'm unable to get to the login page. I always get an Errorcode 500. I read the instructions (https://github.com/beromir/Servas/releases/tag/v0.5.0) according to the change where path for env changed but I don't understand what I have to do.

Attached is a picture of my current settings (unchanged) for Servas.

Can someone help me with this problem?

 

Hi@Armadageddon , 

"The project root in the Docker container is now /app. You have to adjust the volume mapping of the .env file in the compose.yaml file: ./.env:/app/.env."

You need to edit "(.env) File" section and change Container Path:  /var/www/html/.env to /app/.env if i'm not wrong that it  

 

Edited April 14, 20251 yr by HuSoS

@HuSoSThanks for your clarification!

 

I tried to start from scratch and did the following:

- created .env file (with APP_KEY= in it) in appdata/servas/

- created servas.db in appddata/servas

This leads to a error code 500.

Then I changed the settings according to your suggestion. Unfortunately I still get the error code 500.

 

I thought, when I set it up from scratch, that it should be possible to just swap out the servas.db file.

Sadly the app does not work out of the box anymore...