docker-php-startpage
Runs a PHP-based startpage in Docker
- Source code: GitHub
- Docker container: Docker Hub
- Image base: PHP
- Init system: N/A
- Application: N/A
Explanation
- Runs a PHP-based startpage in Docker.
- See Features for more detailed usage information.
Requirements
- Everything is PHP (server-side), so the Docker container running this image will need to be able to reach URLs to do a status check.
- The startpage works out of the box, but it's assumed the user will mount a Docker volume at
/var/www/html/user_includesto include custom configuration files.
Docker image information
Docker image tags
latest: Latest versionX.X.X: Semantic version (use if you want to stick on a specific version)
Environment variables
N/A
Ports
| Port on host | Port in container | Comments |
|---|---|---|
| Choose at your discretion | 80 | Apache |
Volumes
| Volume on host | Volume in container | Comments |
|---|---|---|
| Choose at your discretion | /var/www/html/user_includes | Used to store user config files |
Example usage
Below is an example docker-compose.yml file.
version: '3'
services:
startpage:
container_name: startpage
restart: unless-stopped
networks:
- startpage
ports:
- '80:80'
volumes:
- 'user_includes:/var/www/html/user_includes'
image: loganmarchione/docker-php-startpage:latest
networks:
startpage:
volumes:
user_includes:
driver: local
Below is an example of running locally (used to edit/test/debug).
git clone https://github.com/loganmarchione/docker-php-startpage.git
cd docker-php-startpage
composer update
php -S localhost:8000
TODO
- Learn PHP
- Add a healthcheck
- Make the image smaller (currently ~500MB due to
vendordirectory, maybe load resources from a CDN?) - Add check to make sure JSON is valid (currently, if it's not valid, nothing will load)
- Get
navbar_title_imageconfig option working - Change
config.jsontoconfig.php, since PHP allows setting default variables and comments - Investigate using
curlinstead ofget_headers(curlmight be faster?) - Add a try/except to the
get_headerscall
I like to have my search engine always at hand. But to put it right by the links is not really a pretty sight. With this addition, it can be centered.
when a server is offline I get the following error message. I suspect these will disappear if you can disable debugging/warnings in the apache server. Or possibly some other workarround ?
?
6 Dec 7, 2022
3 Mar 31, 2022
1 Jan 5, 2022
11.7k Jan 7, 2023
83 Feb 8, 2022
7 Nov 17, 2022
9 Dec 27, 2022
2 May 13, 2022
4k Jan 8, 2023
1.1k Dec 17, 2022
5 May 14, 2022
35 Mar 4, 2022
30 Oct 16, 2022
10 Nov 2, 2022
14 May 19, 2022
8 Oct 11, 2022
1 Nov 9, 2021
3 Oct 8, 2022
872 Dec 22, 2022