{"id":13457127,"url":"https://github.com/beromir/Servas","last_synced_at":"2025-03-24T12:30:50.451Z","repository":{"id":37297448,"uuid":"491013693","full_name":"beromir/Servas","owner":"beromir","description":"A self-hosted bookmark management tool.","archived":false,"fork":false,"pushed_at":"2025-03-13T19:12:02.000Z","size":10219,"stargazers_count":637,"open_issues_count":7,"forks_count":31,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-17T14:01:57.099Z","etag":null,"topics":["bookmark-manager","inertiajs","laravel","php","self-hosted","selfhosted","sveltejs","tailwindcss","webapp"],"latest_commit_sha":null,"homepage":"https://servas.app","language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beromir.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-11T08:03:16.000Z","updated_at":"2025-03-15T16:55:55.000Z","dependencies_parsed_at":"2023-10-15T16:21:56.468Z","dependency_job_id":"ab5330c9-1abc-47d4-80f8-75a9777123ae","html_url":"https://github.com/beromir/Servas","commit_stats":{"total_commits":202,"total_committers":5,"mean_commits":40.4,"dds":0.03960396039603964,"last_synced_commit":"44d147c4fad34a170caf01f65b05524b063af265"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beromir%2FServas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beromir%2FServas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beromir%2FServas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beromir%2FServas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beromir","download_url":"https://codeload.github.com/beromir/Servas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245269712,"owners_count":20587831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bookmark-manager","inertiajs","laravel","php","self-hosted","selfhosted","sveltejs","tailwindcss","webapp"],"created_at":"2024-07-31T08:01:33.690Z","updated_at":"2025-03-24T12:30:50.446Z","avatar_url":"https://github.com/beromir.png","language":"Svelte","funding_links":[],"categories":["Svelte","置顶","Software","HarmonyOS","Apps","webapp"],"sub_categories":["9、效率工具集合","Bookmarks and Link Sharing","Windows Manager","KnowledgeBase"],"readme":"# Servas\n\nA self-hosted bookmark management tool.  \nServas is based on Laravel and Inertia.js and uses Tailwind CSS and Svelte for the frontend.\n\n![](./docs/images/home.png \"Home view\")\n\n## Features\n\n- **Tags:** Organize your bookmarks with tags.\n- **Groups:** Group your bookmarks. Groups can be nested.\n- **Smart Groups:** Group your bookmarks based on their belonging tags.\n- **Firefox and Chrome browser extension:** Add sites to Servas right from your browser.\n- **Multiple users:** You can create multiple user accounts.\n- **Responsive design:** Servas looks good on all your devices.\n- **Dark/light theme.**\n- **Two Factor Authentication available.**\n\n## How to install\n\n### Docker\n\nServas is available as an [official Docker image](https://hub.docker.com/r/beromir/servas).\n\nThe preferred way to use Servas is with **SQLite**. This variant does not need an additional database container.  \nYou can find the example files here:\n\n- [compose.yaml](docker/compose.prod.yaml)\n- [.env](docker/.env.prod.example)\n\nThe Docker image also supports **MySQL** and **MariaDB**.  \nYou can find the example files here:\n\n- [compose.yaml](docker/mariadb-example/compose.prod.yaml)\n- [.env](docker/mariadb-example/.env.prod.example)\n\n**Initial steps:**\n\n1. Create `.env` file in the directory where the `compose.yaml` is located.\n2. Copy the content of the example env file into the `.env` file.\n3. Change the `APP_URL`.\n4. Use a strong password for the `DB_PASSWORD` setting (only required if Servas is used with MariaDB).\n5. Start the containers with `docker compose up -d`.\n6. Generate the application key:\n\n```shell\ndocker exec -it servas php artisan key:generate --force\n```\n\n7. Restart the containers with `docker compose restart`.\n8. Open your browser and create a user account at https://your-servas-instance/register.\n\n### Manual\n\n**Requirements:**\n\n- PHP 8.3\n- MariaDB, MySQL or SQLite\n- Git\n- Node.js\n- Composer\n\n1. Clone the repo.\n2. Install the Composer packages.\n\n```shell\ncomposer install --optimize-autoloader --no-dev\n```\n\n3. Install the npm packages.\n\n```shell\nnpm install\n```\n\n4. Compile the assets.\n\n```shell\nnpm run build\n```\n\n5. Create `.env` file from the `.env.example` file.\n6. Change the settings in the `.env` file according to your needs.\n7. If you are using SQLite, you must remove the MySQL section in the `.env` file and uncomment the SQLite section.\n8. Run the database migrations.\n\n```shell\nphp artisan migrate\n```\n\n9. Generate the application key.\n\n```shell\nphp artisan key:generate\n```\n\n## Configuration\n\nYou can change some application settings in the `.env` file.\n\n| Description                      | `.env` key                   | Options        |\n|:---------------------------------|:-----------------------------|:---------------|\n| Enable/Disable user registration | `SERVAS_ENABLE_REGISTRATION` | `true`/`false` |\n\nAfter making changes to the `.env` file, you must restart the application container.\n\n## User Guide\n\nRegister a new user at https://your-servas-instance/register.\n\n## Browser Extensions\n\n**Firefox and Chrome:** https://github.com/beromir/servas-extension\n\n## Screenshots\n\nLinks view:\n![](./docs/images/links.png \"Links view\")\n\nGroups view:\n![](./docs/images/groups.png \"Groups view\")\n\nNew link modal:\n![](./docs/images/new-link.png \"New link modal\")\n\nCommand palette:\n![](./docs/images/command-palette.png \"Command palette\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberomir%2FServas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fberomir%2FServas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberomir%2FServas/lists"}