Giter Club home page Giter Club logo

runtipi's Introduction

⛺️ Tipi — A personal homeserver for everyone

All Contributors

License Version Issues Docker Pulls Docker Image Size Build codecov

Join the discussion

Discord Matrix

Preview

⚠️ Tipi is still at an early stage of development and issues are to be expected. Feel free to open an issue or pull request if you find a bug.

Tipi is a personal homeserver orchestrator. It is running docker containers under the hood and provides a simple web interface to manage them. Every service comes with an opinionated configuration in order to remove the need for manual configuration and network setup.

Check our demo instance : demo.runtipi.com / username: [email protected] / password: runtipi

Apps available

  • Adguard Home - Adguard Home DNS adblocker
  • Booksonic - A server for streaming your audiobooks
  • Calibre-Web - Web Ebook Reader
  • Code-Server - Web VS Code
  • Filebrowser - Web File Browser
  • Firefly III - A personal finances manager
  • Freshrss - A free, self-hostable RSS aggregator
  • Gitea - Gitea - A painless self-hosted Git service
  • Ghost - Ghost - Turn your audience into a business
  • Homarr - A homepage for your server
  • Home Assistant - Open source home automation that puts local control and privacy first
  • Invidious - An alternative front-end to YouTube
  • Jackett - API Support for your favorite torrent trackers
  • Jellyfin - A media server for your home collection
  • Joplin - Privacy focused note-taking app
  • Libreddit - Private front-end for Reddit
  • Mealie - Self-hosted recipe manager and meal planner.
  • n8n - Workflow Automation Tool
  • Nextcloud - A safe home for all your data
  • Nitter - Alternative Twitter front-end
  • Node-RED - Low-code programming for event-driven applications
  • Overseerr - Request management and media discovery tool for the Plex ecosystem
  • Photoprism - AI-Powered Photos App for the Decentralized Web. We are on a mission to protect your freedom and privacy.
  • Pihole - A black hole for Internet advertisements
  • Plex - Stream Movies & TV Shows
  • Portainer - Making Docker and Kubernetes management easy.
  • Prowlarr - A torrent/usenet indexer manager/proxy
  • Radarr - Movie collection manager for Usenet and BitTorrent users
  • Readarr - Book Manager and Automation (Sonarr for Ebooks)
  • Resilio Sync - Fast, reliable, and simple file sync and share solution
  • Sonarr - TV show manager for Usenet and BitTorrent
  • Syncthing - Continuous File Synchronization
  • Tailscale - The easiest, most secure way to use WireGuard and 2FA
  • Tautulli - A Python based monitoring and tracking tool for Plex Media Server
  • Transmission - Fast, easy, and free BitTorrent client
  • Wireguard Easy - WireGuard VPN + Web-based Admin UI
  • Vaultwarden - Unofficial Bitwarden compatible server

You can find and submit new apps inside of the RunTipi Appstore.

🛠 Installation

Installation Requirements

Ubuntu 18.04 LTS or higher is recommended. However other major Linux distribution are supported but may lead to installation issues. Please file an issue if you encounter one.

Step 1. Download Tipi

Run this in an empty directory where you want to install Tipi.

git clone https://github.com/meienberger/runtipi.git

Step 2. Run Tipi

cd into the downloaded directory and run the start script.

cd runtipi
sudo ./scripts/start.sh

The script will prompt you the ip address of the dashboard once configured. Tipi will run by default on port 80. To select another port you can run the start script with the --port argument

sudo ./scripts/start.sh --port 7000

To stop Tipi, run the stop script.

sudo ./scripts/stop.sh

Linking a domain to your dashboard

If you want to link a domain to your dashboard, you can do so by providing the --domain option in the start script.

sudo ./scripts/start.sh --domain mydomain.com

A Let's Encrypt certificate will be generated and installed automatically. Make sure to have ports 80 and 443 open on your firewall and that your domain has an A record pointing to your server IP.

❤️ Contributing

Tipi is made to be very easy to plug in new apps. We welcome and appreciate new contributions.

If you want to add a new app or feature, you can follow the Contribution guide for instructions on how to do so.

📜 License

License

Tipi is licensed under the GNU General Public License v3.0. TL;DR — You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions.

The bash scripts contained in the scripts folder contain a lot of snippets from Umbrel's code. Therefore they contain code licensed under the PolyForm Noncommercial License 1.0.0 license. You can for now consider all scripts under this license. We are actively working on re-writing those parts in order to make them available under the GPL license like the rest of our code.

🗣 Community

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Nicolas Meienberger

💻 🚇 ⚠️ 📖

ArneNaessens

💻 🤔 ⚠️

DrMxrcy

💻 🤔 ⚠️

Cooper

💻

JTruj1ll0923

💻

Stetsed

💻

Jones_Town

💻

Rushi Chaudhari

💻

Robert Blaine

💻

Seth For Privacy

💻

Prajna

💻

Justin Moy

💻

dextreem

💻

This project follows the all-contributors specification. Contributions of any kind welcome!

runtipi's People

Contributors

meienberger avatar allcontributors[bot] avatar arnenaessens avatar drmxrcy avatar stetsed avatar cobredev avatar rblaine95 avatar 0xrushi avatar jtruj1ll0923 avatar imgbotapp avatar michaelyochpaz avatar

Stargazers

bjchend avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.