ionutradis / shaark Goto Github PK

Shaark is a self-hosted platform to keep and share your content: web links, posts, passwords and pictures.

All of your data can be private, public or both and can be browsed by tags or all-in-one search.

Shaark is production ready, inspired by Shaarli, built with Laravel and Vue.js.

Features / Demo / Documentation / Contribute / Security / Tests / Licence

• Links : to keep your bookmarks
• Stories : posts with markdown flavored content
• Chests : to save your passwords
• Albums : to host your pictures
• Rapid sharing extension and Progressive Web App
• Tagging system, walls, search and RSS feeds
• Private content or entirely private (with temp sharing)
• Theming (dark mode, background)
• i18n (🇬🇧, 🇫🇷, 🇩🇪, 🇯🇵)
• Archiving (as pdf, as media)
• DB encryption, 2-FA, Multi-users, backup

A public demo is available at https://shaark.mka.ovh. Credentials are [email protected] and secret. This demo is resetted hourly.

• Installation: How to install Shaark
• Troubleshooting: Common issues
• Changelog: Extensive changelog
• Archiving: How to run PDF and Media archiving
• Backup: How to set up automatic backup
• Comments: How comment system work
• Dependencies: Dependencies used by Shaark

All contributions are welcome! Please use the dev branch for your pull requests.
If you make changes to JS, don't compile assets in production, I'll manually compile them when merging for security reasons.

Shaark is actually available in English, French and German. Feel free to make a pull request to add or update a localization. You can see laravel base localizations on this repo.

You host your own Shaark public instance and you want to share it with other users? You can make a pull request to add it to our public listing located at directory.md.

If you find any security issues, please send me an email (can be found in composer.json).

If you don't want your content being publicy accessible, you can update this preference once application is installed from settings section.

You're able to active 2-FA (2 factors authentication). By default 2-FA is disabled but you can update it from your app settings. Code length and code expiration are also configurable. Test if you application can send emails before enabling this feature.

Shaark logs all successful and failed auths with their associated devices.

Since 1.2.9, all chests data are encrypted in your database using AES-256-CBC and your app key.

Others users can be admin or non-admin. Admin users are like the main user and have an access to the entire content. Non-admin users can't access the settings section and can only see their own private content.

1. Be sure to have a testing database with touch database/testing.sqlite and have composer require-dev dependencies installer.
2. Run testing server php artisan serve --env=testing.
3. Run tests php artisan dusk --env=testing

MIT