mirror of
				https://github.com/karl0ss/homepage.git
				synced 2025-11-04 08:20:58 +00:00 
			
		
		
		
	update readme
This commit is contained in:
		
							parent
							
								
									f0ca7b753f
								
							
						
					
					
						commit
						adeffbcf71
					
				
							
								
								
									
										105
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										105
									
								
								README.md
									
									
									
									
									
								
							@ -5,30 +5,30 @@
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Features
 | 
					## Features
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  * Fast! The entire site is statically generated at build time, so you can expect instant load times
 | 
					- Fast! The entire site is statically generated at build time, so you can expect instant load times
 | 
				
			||||||
  * Images built for AMD64 (x86_64), ARM64, ARMv7 and ARMv6
 | 
					- Images built for AMD64 (x86_64), ARM64, ARMv7 and ARMv6
 | 
				
			||||||
    - Supports all Raspberry Pi's, most SBCs & Apple Silicon
 | 
					  - Supports all Raspberry Pi's, most SBCs & Apple Silicon
 | 
				
			||||||
  * Full i18n support with automatic language detection
 | 
					- Full i18n support with automatic language detection
 | 
				
			||||||
    - Translations for Chinese, Dutch, French, German, Norwegian Bokmål, Portuguese, Russian and Spanish
 | 
					  - Translations for Chinese, Dutch, French, German, Norwegian Bokmål, Portuguese, Russian and Spanish
 | 
				
			||||||
    - Want to help translate? [Join the Weblate project](https://hosted.weblate.org/engage/homepage/)
 | 
					  - Want to help translate? [Join the Weblate project](https://hosted.weblate.org/engage/homepage/)
 | 
				
			||||||
  * Service & Web Bookmarks
 | 
					- Service & Web Bookmarks
 | 
				
			||||||
  * Docker Integration
 | 
					- Docker Integration
 | 
				
			||||||
    - Container status (Running / Stopped) & statistics (CPU, Memory, Network)
 | 
					  - Container status (Running / Stopped) & statistics (CPU, Memory, Network)
 | 
				
			||||||
    - Automatic service discovery (via labels)
 | 
					  - Automatic service discovery (via labels)
 | 
				
			||||||
  * Service Integration
 | 
					- Service Integration
 | 
				
			||||||
    - Sonarr, Radarr, Readarr, Prowlarr, Emby, Jellyfin, Tautulli (Plex)
 | 
					  - Sonarr, Radarr, Readarr, Prowlarr, Emby, Jellyfin, Tautulli (Plex)
 | 
				
			||||||
    - Ombi, Overseerr, Jellyseerr, NZBGet, SABnzbd, ruTorrent, Transmission
 | 
					  - Ombi, Overseerr, Jellyseerr, NZBGet, SABnzbd, ruTorrent, Transmission
 | 
				
			||||||
    - Portainer, Traefik, Speedtest Tracker, PiHole, Nginx Proxy Manager, Gotify
 | 
					  - Portainer, Traefik, Speedtest Tracker, PiHole, Nginx Proxy Manager, Gotify
 | 
				
			||||||
  * Information Providers
 | 
					- Information Providers
 | 
				
			||||||
    - Coin Market Cap
 | 
					  - Coin Market Cap
 | 
				
			||||||
  * Information & Utility Widgets
 | 
					- Information & Utility Widgets
 | 
				
			||||||
    - System Stats (Disk, CPU, Memory)
 | 
					  - System Stats (Disk, CPU, Memory)
 | 
				
			||||||
    - Weather via WeatherAPI.com or OpenWeatherMap
 | 
					  - Weather via WeatherAPI.com or OpenWeatherMap
 | 
				
			||||||
      - Automatic location detection (with HTTPS), or manual location selection
 | 
					    - Automatic location detection (with HTTPS), or manual location selection
 | 
				
			||||||
    - Search Bar
 | 
					  - Search Bar
 | 
				
			||||||
  * Customizable
 | 
					- Customizable
 | 
				
			||||||
    - 21 theme colors with light and dark mode support
 | 
					  - 21 theme colors with light and dark mode support
 | 
				
			||||||
    - Background image support
 | 
					  - Background image support
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Support & Suggestions
 | 
					## Support & Suggestions
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -45,16 +45,17 @@ For configuration options, examples and more, [please check out the Wiki](https:
 | 
				
			|||||||
Using docker compose:
 | 
					Using docker compose:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```yaml
 | 
					```yaml
 | 
				
			||||||
version: '3.3'
 | 
					version: "3.3"
 | 
				
			||||||
services:
 | 
					services:
 | 
				
			||||||
    homepage:
 | 
					  homepage:
 | 
				
			||||||
        image: ghcr.io/benphelps/homepage:latest
 | 
					    image: ghcr.io/benphelps/homepage:latest
 | 
				
			||||||
        container_name: homepage
 | 
					    container_name: homepage
 | 
				
			||||||
        ports:
 | 
					    user: 1000:1000 # Optional, change to your user and group IDs for permissions
 | 
				
			||||||
            - 3000:3000
 | 
					    ports:
 | 
				
			||||||
        volumes:
 | 
					      - 3000:3000
 | 
				
			||||||
            - /path/to/config:/app/config
 | 
					    volumes:
 | 
				
			||||||
            - /var/run/docker.sock:/var/run/docker.sock # (optional) For docker integrations
 | 
					      - /path/to/config:/app/config # Make sure your local config directory is exists
 | 
				
			||||||
 | 
					      - /var/run/docker.sock:/var/run/docker.sock # (optional) For docker integrations
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
or docker run:
 | 
					or docker run:
 | 
				
			||||||
@ -90,7 +91,7 @@ pnpm start
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
Configuration files will be genereted and placed on the first request.
 | 
					Configuration files will be genereted and placed on the first request.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Configuration is done in the /config directory using .yaml files.  Refer to each config for
 | 
					Configuration is done in the /config directory using .yaml files. Refer to each config for
 | 
				
			||||||
the specific configuration options.
 | 
					the specific configuration options.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You may also check [the wiki](https://github.com/benphelps/homepage/wiki) for detailed configuration instructions, examples and more.
 | 
					You may also check [the wiki](https://github.com/benphelps/homepage/wiki) for detailed configuration instructions, examples and more.
 | 
				
			||||||
@ -115,22 +116,22 @@ This is a [Next.js](https://nextjs.org/) application, see their doucmentation fo
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
## Contributors
 | 
					## Contributors
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Huge thanks to the all the contributors who have helped make this project what it is today!  In alphabetical order:
 | 
					Huge thanks to the all the contributors who have helped make this project what it is today! In alphabetical order:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  * [aidenpwnz](https://github.com/benphelps/homepage/commits?author=aidenpwnz) - Nginx Proxy Manager, Search Bar Widget
 | 
					- [aidenpwnz](https://github.com/benphelps/homepage/commits?author=aidenpwnz) - Nginx Proxy Manager, Search Bar Widget
 | 
				
			||||||
  * [AlexFullmoon](https://github.com/benphelps/homepage/commits?author=AlexFullmoon) - OpenWeatherMap Widget
 | 
					- [AlexFullmoon](https://github.com/benphelps/homepage/commits?author=AlexFullmoon) - OpenWeatherMap Widget
 | 
				
			||||||
  * [AmadeusGraves](https://github.com/benphelps/homepage/commits?author=AmadeusGraves) - Spanish Translation
 | 
					- [AmadeusGraves](https://github.com/benphelps/homepage/commits?author=AmadeusGraves) - Spanish Translation
 | 
				
			||||||
  * [boerniee](https://github.com/benphelps/homepage/commits?author=boerniee) - German Translation
 | 
					- [boerniee](https://github.com/benphelps/homepage/commits?author=boerniee) - German Translation
 | 
				
			||||||
  * [comradekingu](https://github.com/benphelps/homepage/commits?author=comradekingu) - Norwegian Bokmål Translation
 | 
					- [comradekingu](https://github.com/benphelps/homepage/commits?author=comradekingu) - Norwegian Bokmål Translation
 | 
				
			||||||
  * [deffcolony](https://github.com/benphelps/homepage/commits?author=deffcolony) - Dutch Translation
 | 
					- [deffcolony](https://github.com/benphelps/homepage/commits?author=deffcolony) - Dutch Translation
 | 
				
			||||||
  * [desolaris](https://github.com/benphelps/homepage/commits?author=desolaris) - Russian Translation
 | 
					- [desolaris](https://github.com/benphelps/homepage/commits?author=desolaris) - Russian Translation
 | 
				
			||||||
  * [ilusi0n](https://github.com/benphelps/homepage/commits?author=ilusi0n) - Jellyseerr Integration
 | 
					- [ilusi0n](https://github.com/benphelps/homepage/commits?author=ilusi0n) - Jellyseerr Integration
 | 
				
			||||||
  * [ItsJustMeChris](https://github.com/benphelps/homepage/commits?author=ItsJustMeChris) - Coin Market Cap Widget
 | 
					- [ItsJustMeChris](https://github.com/benphelps/homepage/commits?author=ItsJustMeChris) - Coin Market Cap Widget
 | 
				
			||||||
  * [jackblk](https://github.com/benphelps/homepage/commits?author=jackblk) - Vietnamese Translation
 | 
					- [jackblk](https://github.com/benphelps/homepage/commits?author=jackblk) - Vietnamese Translation
 | 
				
			||||||
  * [JazzFisch](https://github.com/benphelps/homepage/commits?author=JazzFisch) - Readarr, SABnzbd & Transmission Integrations
 | 
					- [JazzFisch](https://github.com/benphelps/homepage/commits?author=JazzFisch) - Readarr, Bazarr, Lidarr, SABnzbd & Transmission Integrations
 | 
				
			||||||
  * [modem7](https://github.com/benphelps/homepage/commits?author=modem7) - Impvoed Docker Image
 | 
					- [modem7](https://github.com/benphelps/homepage/commits?author=modem7) - Impvoed Docker Image
 | 
				
			||||||
  * [nicedc](https://github.com/benphelps/homepage/commits?author=nicedc) - Chinese Translation
 | 
					- [nicedc](https://github.com/benphelps/homepage/commits?author=nicedc) - Chinese Translation
 | 
				
			||||||
  * [Nonoss117](https://github.com/benphelps/homepage/commits?author=Nonoss117) - French Translation
 | 
					- [Nonoss117](https://github.com/benphelps/homepage/commits?author=Nonoss117) - French Translation
 | 
				
			||||||
  * [quod](https://github.com/benphelps/homepage/commits?author=quod) - Fixed Typos
 | 
					- [quod](https://github.com/benphelps/homepage/commits?author=quod) - Fixed Typos
 | 
				
			||||||
  * [schklom](https://github.com/benphelps/homepage/commits?author=schklom) - ARM64, ARMv7 and ARMv6
 | 
					- [schklom](https://github.com/benphelps/homepage/commits?author=schklom) - ARM64, ARMv7 and ARMv6
 | 
				
			||||||
  * [xicopitz](https://github.com/benphelps/homepage/commits?author=xicopitz) - Gotify & Prowlarr Integration
 | 
					- [xicopitz](https://github.com/benphelps/homepage/commits?author=xicopitz) - Gotify & Prowlarr Integration
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user