my-idlers/README.md

328 lines
8.3 KiB
Markdown
Raw Normal View History

2021-01-20 04:35:24 +01:00
# My idlers
A web app for displaying, organizing and storing information about servers (VPS), shared & reseller hosting, seed boxes,
domains,
DNS and misc services.
Despite what the name infers this self hosted web app isn't just for storing idling server information. By using
2022-11-02 12:02:12 +01:00
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
[![Generic badge](https://img.shields.io/badge/version-2.1.8-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-05-22 05:35:32 +02:00
<img src="https://raw.githubusercontent.com/cp6/my-idlers/main/public/My%20Idlers%20logo.jpg" width="128" height="128" />
[Demo site](https://demo.myidlers.com/)
2022-05-22 05:35:32 +02:00
2022-06-01 15:37:23 +02:00
**Note:** Create, Update and Delete are disabled on demo site.
## Project sponsor
[Cloud Five Limited](https://cloud-v.net/) for providing the hosting for demo installation.
2021-08-19 09:24:28 +02:00
## 2.1.8 changes (20th October 2022):
2022-09-22 05:30:34 +02:00
#### You can no longer use the form to submit YABS results
yabs.sh now has JSON formatted response and can POST the output directly from calling the script.
2022-09-22 05:30:34 +02:00
With My idlers you can use your API key and the server id to directly POST the benchmark result
`http://domain.com/api/yabs/tnSJLyhz/USERAPIKEYISHERE`
Example yabs.sh call to POST the result
`curl -sL yabs.sh | bash -s -- -s "http://domain.com/api/yabs/tnSJLyhz/USERAPIKEYISHERE"`
### NPM / Laravel mix now in use
```shell
npm install
npm run prod
```
#### Please run the following if updating from existing install:
```shell
php artisan route:cache
php artisan cache:clear
```
* Added & implemented details footer blade component
* Added new index layout
* Updated domains, misc, reseller, seedboxes and shared use new index layout
2022-10-20 06:41:33 +02:00
* Updated validation for store and update
* Updated `updatePricing()` to not need `$as_usd` parameter
* Updated labels assigned insert
* Updated order/sort by methods for pricing related columns
2022-11-02 12:02:12 +01:00
* Removed add YABS button on servers index page
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
* PHP 8.1
2021-01-20 04:35:24 +01:00
2021-01-20 04:55:09 +01:00
## Features
2021-01-20 04:35:24 +01:00
* Add servers
* Add shared hosting
* Add domains
* [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)
2022-11-02 12:02:12 +01:00
* Get YABS data from output
2021-02-06 15:28:39 +01:00
* Compare 2 servers
2022-11-02 12:02:12 +01:00
* Save & view YABS output
* 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
* 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
* 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`
## Updating
2022-05-16 08:46:08 +02:00
If you already have at least version 2.0 installed:
2022-05-16 08:46:08 +02:00
* Run `git clone https://github.com/cp6/my-idlers.git`
* Run `composer install`
* Run `php artisan migrate`
* Run `php artisan route:cache`
* Run `php artisan cache:clear`
2022-05-16 08:46:08 +02:00
## Run using Docker
2022-05-16 08:46:08 +02:00
```
docker run \
-p 8000:8000\
-e APP_URL=https://... \
-e DB_HOST=... \
-e DB_DATABASE=... \
-e DB_USERNAME=... \
-e DB_PASSWORD=... \
ghcr.io/cp6/my-idlers:latest
2022-03-14 07:51:41 +01:00
docker exec ... php artisan migrate:fresh --seed --force # Set up database one time
```
## Managed Hosting
Run with a single click on [PikaPods.com](https://www.pikapods.com/)
[![PikaPods](https://www.pikapods.com/static/run-button.svg)](https://www.pikapods.com/pods?run=my-idlers)
## API endpoints
2021-01-20 04:35:24 +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
`Authorization : Bearer API_TOKEN_HERE`
2021-01-20 04:55:09 +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
**GET request:**
2021-01-20 04:55:09 +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
`networkSpeeds/`
2021-01-20 04:35:24 +01:00
`networkSpeeds/{id}`
2021-01-20 04:35:24 +01:00
`os/`
2021-01-20 04:35:24 +01:00
`os/{id}`
2021-01-20 04:35:24 +01:00
`pricing/`
`pricing/{id}`
2021-01-20 04:35:24 +01:00
`providers/`
`providers/{id}`
2021-01-20 04:35:24 +01:00
`reseller/`
`reseller/{id}`
2021-01-20 04:35:24 +01:00
2022-05-16 08:46:08 +02:00
`seedbox/`
`seedbox/{id}`
`settings/`
`shared/`
`shared/{id}`
**POST requests**
Create a server
`/servers`
Body content template
```json
{
"active": 1,
"show_public": 0,
"hostname": "test.domain.com",
"ns1": "ns1",
"ns2": "ns2",
"server_type": 1,
"os_id": 2,
"provider_id": 10,
"location_id": 15,
"ssh_port": 22,
"bandwidth": 2000,
"ram": 2024,
"ram_type": "MB",
"ram_as_mb": 2024,
"disk": 30,
"disk_type": "GB",
"disk_as_gb": 30,
"cpu": 2,
"has_yabs": 0,
"was_promo": 1,
"ip1": "127.0.0.1",
"ip2": null,
"owned_since": "2022-01-01",
"currency": "USD",
"price": 4.00,
"payment_term": 1,
"as_usd": 4.00,
"usd_per_month": 4.00,
"next_due_date": "2022-02-01"
}
```
**PUT requests**
Update a server
`/servers/ID`
Body content template
```json
{
"active": 1,
"show_public": 0,
"hostname": "test.domain.com",
"ns1": "ns1",
"ns2": "ns2",
"server_type": 1,
"os_id": 2,
"provider_id": 10,
"location_id": 15,
"ssh_port": 22,
"bandwidth": 2000,
"ram": 2024,
"ram_type": "MB",
"ram_as_mb": 2024,
"disk": 30,
"disk_type": "GB",
"disk_as_gb": 30,
"cpu": 2,
"has_yabs": 0,
"was_promo": 1,
"owned_since": "2022-01-01"
}
```
Update pricing
`/pricing/ID`
Body content template
```json
{
"price": 10.50,
"currency": "USD",
"term": 1
}
```
**DELETE requests**
Delete a server
`/servers/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```
2022-11-02 12:02:12 +01:00
**Make sure YABS output starts at the first line which is:**
```# ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## #```
Logo icons created by Freepik - Flaticon
## Screenshots for v2
[![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)
[![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
[![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)
2022-11-02 13:09:17 +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
[![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)
[![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)
[![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)
[![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)