Repository files navigation

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

• Tags: Organize your bookmarks with tags.
• Groups: Group your bookmarks. Groups can be nested.
• Smart Groups: Group your bookmarks based on their belonging tags.
• Firefox and Chrome browser extension: Add sites to Servas right from your browser.
• Multiple users: You can create multiple user accounts.
• Responsive design: Servas looks good on all your devices.
• Import/Export: Support for JSON and HTML bookmarks.
• Dark/light theme.
• Two Factor Authentication available.

Servas is available as anofficial Docker image.

The preferred way to use Servas is withSQLite. This variant does not need an additional database container.
You can find the example files here:

• compose.yaml
• .env

The Docker image also supportsMySQL andMariaDB.
You can find the example files here:

• compose.yaml
• .env

Initial steps:

1. Create.env file in the directory where thecompose.yaml is located.
2. Copy the content of the example env file into the.env file.
3. Change theAPP_URL.
4. Use a strong password for theDB_PASSWORD setting (only required if Servas is used with MariaDB).
5. Start the containers withdocker compose up -d.
6. Generate the application key:

dockerexec -it servas php artisan key:generate --force

7. Restart the containers withdocker compose restart.
8. Open your browser and create a user account athttps://your-servas-instance/register.

Requirements:

• PHP 8.3
• MariaDB, MySQL or SQLite
• Git
• Node.js
• Composer

1. Clone the repo.
2. Install the Composer packages.

composer install --optimize-autoloader --no-dev

3. Install the npm packages.

npm install

4. Compile the assets.

npm run build

5. Create.env file from the.env.example file.
6. Change the settings in the.env file according to your needs.
7. If you are using SQLite, you must remove the MySQL section in the.env file and uncomment the SQLite section.
8. Run the database migrations.

php artisan migrate

9. Generate the application key.

php artisan key:generate

You can change some application settings in the.env file.

After making changes to the.env file, you must restart the application container.

Register a new user athttps://your-servas-instance/register.

Firefox and Chrome:https://github.com/beromir/servas-extension

Visit thewebsite.