2021-01-20 04:35:24 +01:00
# My idlers
2022-05-16 13:35:33 +02:00
A web app for displaying, organizing and storing information about servers (VPS), shared & reseller hosting, seed boxes, domains,
2022-03-05 16:22:28 +01:00
DNS and misc services.
Despite what the name infers this self hosted web app isn't just for storing idling server information. By using
a [YABs ](https://github.com/masonr/yet-another-bench-script ) output you can get disk & network speed values along with
GeekBench 5 scores to do easier comparing and sorting.
2021-01-20 04:35:24 +01:00
2022-05-16 13:35:33 +02:00
[![Generic badge ](https://img.shields.io/badge/version-2.1.0-blue.svg )](https://shields.io/) [![Generic badge ](https://img.shields.io/badge/Laravel-9.0-red.svg )](https://shields.io/) [![Generic badge ](https://img.shields.io/badge/PHP-8.1-purple.svg )](https://shields.io/) [![Generic badge ](https://img.shields.io/badge/Bootstrap-5.1-pink.svg )](https://shields.io/)
2022-03-06 11:29:06 +01:00
## Project sponsor
2022-02-04 13:50:18 +01:00
2022-03-06 11:29:06 +01:00
[Cloud Five Limited ](https://cloud-v.net/ ) for providing the hosting for demo installation.
2021-08-19 09:24:28 +02:00
2022-05-16 08:46:08 +02:00
## 2.1.0 changes:
* Added Seedbox CRUD
* Added dark mode (settings option. Bootstrap-Night https://vinorodrigues.github.io/bootstrap-dark-5/)
* Added some foreign keys for certain tables
* Added functions for IP and label assignments
* Added functions to forget (clear) cache, preventing chunks of duplicate code
* Added VMware to server virt select dropdown options
* Added Kharkiv and Sao Paulo to locations seeder
* Updated Controllers with DB calls and logic moved to relevant Model
2022-05-16 13:35:33 +02:00
* Updated YABs inserts for version v2022-05-06
2022-05-16 08:46:08 +02:00
* Updated DB calls for caching
* Updated home page view links on recently added
2022-05-16 13:35:33 +02:00
* Fixed YABs insert error not displaying
2021-01-20 04:35:24 +01:00
2021-01-20 04:55:09 +01:00
## Requires
2021-01-20 04:35:24 +01:00
2022-05-16 08:46:08 +02:00
* PHP 8 (8.1 recommended)
2021-01-20 04:35:24 +01:00
2021-01-20 04:55:09 +01:00
## Features
2022-03-05 16:22:28 +01:00
2021-01-20 04:35:24 +01:00
* Add servers
* Add shared hosting
* Add domains
2021-01-29 01:42:44 +01:00
* [Auto get IP's from hostname ](https://cdn.write.corbpie.com/wp-content/uploads/2021/01/my-idlers-self-hosted-server-domain-information-ips-from-hostname.gif )
* [Check up/down status ](https://cdn.write.corbpie.com/wp-content/uploads/2021/01/my-idlers-self-hosted-server-domain-information-ping-up-feature.gif )
2021-01-20 04:35:24 +01:00
* Get YABs data from output
2021-02-06 15:28:39 +01:00
* Compare 2 servers
2021-01-20 04:35:24 +01:00
* Save & view YABs output
2021-01-29 01:42:44 +01:00
* Update YABs disk & network results
2021-01-20 04:35:24 +01:00
* Next due date system
* Multi currency compatibility
* Multi payment-term compatibility
* Pre-defined operating systems
2021-01-31 02:46:46 +01:00
* Assign labels
2021-01-20 04:35:24 +01:00
* Assign server type (KVM, OVZ, LXC & dedi)
* Easy to edit values
2021-01-20 04:55:09 +01:00
## Install
2021-01-20 04:35:24 +01:00
2022-03-06 03:03:59 +01:00
* Run `git clone https://github.com/cp6/my-idlers.git` into your directory of choice
2022-03-05 16:22:28 +01:00
* Run `composer install`
* Run `cp .env.example .env`
* Edit (If needed) MySQL details in .env
* Run `php artisan key:generate`
* Run `php artisan make:database my_idlers` to create database
* Run `php artisan migrate:fresh --seed` to create tables and seed data
* Run `php artisan serve`
2021-01-31 02:46:46 +01:00
2022-05-16 08:46:08 +02:00
## Update
If you have at least version 2.0 installed:
* Run `git clone https://github.com/cp6/my-idlers.git`
* Run `composer install`
* Run `php artisan migrate`
2022-03-14 07:19:11 +01:00
## Run using Docker
2022-05-16 08:46:08 +02:00
2022-03-14 07:19:11 +01:00
```
docker run \
-p 8000:8000\
-e APP_URL=https://... \
-e DB_HOST=... \
-e DB_DATABASE=... \
-e DB_USERNAME=... \
-e DB_PASSWORD=... \
ghcr.io/m3nu/my-idlers:latest # TODO: adjust after official image is set up!
2022-03-14 07:51:41 +01:00
docker exec ... php artisan migrate:fresh --seed --force # Set up database one time
2022-03-14 07:19:11 +01:00
```
2022-03-05 16:22:28 +01:00
## API endpoints
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
For GET requests the header must have `Accept: application/json` and your API token (found at `/account` )
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`Authorization : Bearer API_TOKEN_HERE`
2021-01-20 04:55:09 +01:00
2022-03-05 16:22:28 +01:00
All API requests must be appended with `api/` e.g `mydomain.com/api/servers/gYk8J0a7`
2021-01-20 04:55:09 +01:00
2022-03-05 16:22:28 +01:00
**GET request:**
2021-01-20 04:55:09 +01:00
2022-03-05 16:22:28 +01:00
`dns/`
`dns/{id}`
`domains/`
`domains/{id}`
`servers`
`servers/{id}`
`labels/`
`labels/{id}`
`locations/`
`locations/{id}`
`misc/`
`misc/{id}`
2021-01-20 04:55:09 +01:00
2022-03-05 16:22:28 +01:00
`networkSpeeds/`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`networkSpeeds/{id}`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`os/`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`os/{id}`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`pricing/`
2021-01-20 04:41:37 +01:00
2022-03-05 16:22:28 +01:00
`pricing/{id}`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`providers/`
2021-01-20 04:41:37 +01:00
2022-03-05 16:22:28 +01:00
`providers/{id}`
2021-01-20 04:35:24 +01:00
2022-03-05 16:22:28 +01:00
`reseller/`
2021-01-20 04:41:37 +01:00
2022-03-05 16:22:28 +01:00
`reseller/{id}`
2021-01-20 04:35:24 +01:00
2022-05-16 08:46:08 +02:00
`seedbox/`
`seedbox/{id}`
2022-03-05 16:22:28 +01:00
`settings/`
`shared/`
`shared/{id}`
## Notes
**Public viewable listings**
If enabled the public viewable table for your server listings is at `/servers/public`
You can configure what you want viewable at ```/settings```
**Due date / due soon**
This is simply just a reminder. If the homepage is requested (viewed) when a service is over due date it will get reset
to plus the term from the old due date.
E.g if the term is a month then the due date gets updated to be 1 month from the old due date.
**Supporting YABS commands:**
```curl -sL yabs.sh | bash```
or
```curl -sL yabs.sh | bash -s -- -r```
**Make sure YABs output starts at the first line which is:**
```# ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## #```
2021-01-20 04:41:37 +01:00
2022-03-05 16:22:28 +01:00
## Screenshots for v2
2021-01-29 01:42:44 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot1 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-home-2.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-home-2.jpg)
2021-01-20 04:41:37 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot2 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-server-view.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-server-view.jpg)
2021-01-20 04:35:24 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot3 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-servers-home.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-servers-home.jpg)
2021-01-20 04:41:37 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot4 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-YABs.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-YABs.jpg)
2021-01-20 04:35:24 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot5 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-add-server_2.png )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-add-server_2.png)
2021-01-29 01:42:44 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot6 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-servers-compare.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-servers-compare.jpg)
2021-01-29 01:42:44 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot7 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-Ips.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-Ips.jpg)
2021-01-29 01:42:44 +01:00
2022-03-09 03:18:30 +01:00
[![My idlers screenshot8 ](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-labels.jpg )](https://cdn.write.corbpie.com/wp-content/uploads/2022/03/My-idlers-v2-labels.jpg)