Skip to content

Commit fb049ef

Browse files
committed
create guides folder and clean the readme
1 parent e75da74 commit fb049ef

3 files changed

Lines changed: 223 additions & 218 deletions

File tree

README.md

Lines changed: 8 additions & 215 deletions
Original file line numberDiff line numberDiff line change
@@ -293,7 +293,7 @@ If you need a special support. Contact me, more details in the [Help & Questions
293293

294294

295295
<a name="Docker"></a>
296-
### [Docker]
296+
297297

298298

299299

@@ -475,7 +475,6 @@ docker logs {container-name}
475475

476476
<br>
477477
<a name="Laravel"></a>
478-
### [Laravel]
479478

480479

481480

@@ -704,7 +703,6 @@ More details about this [here](https://github.com/jenssegers/laravel-mongodb#ins
704703

705704
<br>
706705
<a name="PHP"></a>
707-
### [PHP]
708706

709707

710708

@@ -857,220 +855,15 @@ To controll the behavior of xDebug (in the `php-fpm` Container), you can run the
857855

858856
<br>
859857
<a name="Production"></a>
860-
### [Production]
858+
859+
861860

862861

863862
<br>
864863
<a name="Digital-Ocean"></a>
865864
### Setup Laravel and Docker on Digital Ocean
866865

867-
868-
#### Install Docker
869-
```
870-
Login Digital Ocean
871-
Add Droplet
872-
1 Click Install docker
873-
Choose Droplet
874-
reset ROOT password
875-
check email
876-
```
877-
878-
#### SSH to your Server
879-
880-
```
881-
ssh root@ipaddress
882-
```
883-
you will be prompt of that password.
884-
type the password you receive in your email
885-
886-
then it will ask to you to change a new password
887-
just change it to the custom root password you want
888-
889-
After SSH
890-
you can check that docker command is working by typing
891-
892-
```
893-
$root@midascode:~# docker
894-
```
895-
896-
#### Set Up Your Laravel Project
897-
898-
```
899-
$root@midascode:~# apt-get install git
900-
$root@midascode:~# git clone https://github.com/laravel/laravel
901-
$root@midascode:~# cd laravel
902-
$root@midascode:~/laravel# git checkout develop
903-
$root@midascode:~/laravel/ git submodule add https://github.com/LaraDock/laradock.git
904-
$root@midascode:~/laravel/ cd laradock
905-
```
906-
907-
#### Install docker-compose command
908-
909-
```
910-
$root@midascode:~/laravel/laradock# curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose
911-
$root@midascode:~/chmod +x /usr/local/bin/docker-compose
912-
```
913-
914-
#### Create Your LaraDock Containers
915-
916-
```
917-
$root@midascode:~/laravel/laradock# docker-compose up -d nginx mysql
918-
```
919-
920-
#### Go to Your Workspace
921-
922-
```
923-
docker-compose exec workspace bash
924-
```
925-
926-
#### Install laravel Dependencies, Add .env , generate Key and give proper permission certain folder
927-
928-
```
929-
$ root@0e77851d27d3:/var/www/laravel# composer install
930-
$ root@0e77851d27d3:/var/www/laravel# cp .env.example .env
931-
$ root@0e77851d27d3:/var/www/laravel# php artisan key:generate
932-
$ root@0e77851d27d3:/var/www/laravel# exit
933-
$root@midascode:~/laravel/laradock# cd ..
934-
$root@midascode:~/laravel# sudo chmod -R 777 storage bootstrap/cache
935-
```
936-
937-
you can then view your laravel site at your ipaddress
938-
for example
939-
```
940-
192.168.1.1
941-
```
942-
943-
You will see there Laravel Default Welcome Page
944-
945-
but if you need to view on your custom domain name
946-
which you would.
947-
948-
#### Using Your Own Domain Name
949-
login to your DNS provider
950-
Godaddy, Namecheap what ever...
951-
And Point the Custom Domain Name Server to
952-
953-
```
954-
ns1.digitalocean.com
955-
ns2.digitalocean.com
956-
ns3.digitalocean.com
957-
```
958-
In Your Digital Ocean Account go to
959-
```
960-
https://cloud.digitalocean.com/networking/domains
961-
```
962-
add your domain name and choose the server ip you provision earlier
963-
964-
#### Serve Site With NGINX (HTTP ONLY)
965-
Go back to command line
966-
```
967-
$root@midascode:~/laravel/laradock# cd nginx
968-
$root@midascode:~/laravel/laradock/nginx# vim laravel.conf
969-
```
970-
remove default_server
971-
```
972-
973-
listen 80 default_server;
974-
listen [::]:80 default_server ipv6only=on;
975-
976-
```
977-
and add server_name (your custom domain)
978-
```
979-
listen 80;
980-
listen [::]:80 ipv6only=on;
981-
server_name yourdomain.com;
982-
```
983-
984-
#### Rebuild Your Nginx
985-
```
986-
$root@midascode:~/laravel/laradock/nginx# docker-compose down
987-
$root@midascode:~/laravel/laradock/nginx# docker-compose build nginx
988-
```
989-
990-
#### Re Run Your Containers MYSQL and NGINX
991-
```
992-
$root@midascode:~/laravel/laradock/nginx# docker-compose up -d nginx mysql
993-
```
994-
995-
###### View Your Site with HTTP ONLY (http://yourdomain.com)
996-
997-
#### Run Site on SSL with Let's Encrypt Certificate
998-
999-
###### Note: You need to Use Caddy here Instead of Nginx
1000-
1001-
###### To go Caddy Folders and Edit CaddyFile
1002-
1003-
```
1004-
$root@midascode:~/laravel/laradock# cd caddy
1005-
$root@midascode:~/laravel/laradock/caddy# vim Caddyfile
1006-
```
1007-
1008-
Remove 0.0.0.0:80
1009-
1010-
```
1011-
0.0.0.0:80
1012-
root /var/www/laravel/public
1013-
```
1014-
and replace with your https://yourdomain.com
1015-
1016-
```
1017-
https://yourdomain.com
1018-
root /var/www/laravel/public
1019-
```
1020-
uncomment tls
1021-
1022-
```
1023-
#tls self-signed
1024-
```
1025-
and replace self-signed with your email address
1026-
1027-
```
1028-
tls midascodebreaker@gmai.com
1029-
```
1030-
This is needed Prior to Creating Let's Encypt
1031-
1032-
#### Run Your Caddy Container without the -d flag and Generate SSL with Let's Encrypt
1033-
1034-
```
1035-
$root@midascode:~/laravel/laradock/caddy# docker-compose up caddy
1036-
```
1037-
1038-
you will be prompt here to enter your email... you may enter it or not
1039-
```
1040-
Attaching to laradock_mysql_1, laradock_caddy_1
1041-
caddy_1 | Activating privacy features...
1042-
caddy_1 | Your sites will be served over HTTPS automatically using Let's Encrypt.
1043-
caddy_1 | By continuing, you agree to the Let's Encrypt Subscriber Agreement at:
1044-
caddy_1 | https://letsencrypt.org/documents/LE-SA-v1.0.1-July-27-2015.pdf
1045-
caddy_1 | Activating privacy features... done.
1046-
caddy_1 | https://yourdomain.com
1047-
caddy_1 | http://yourdomain.com
1048-
```
1049-
1050-
After it finish Press Ctrl + C to exit ...
1051-
1052-
#### Stop All Containers and ReRun Caddy and Other Containers on Background
1053-
1054-
```
1055-
$root@midascode:~/laravel/laradock/caddy# docker-compose down
1056-
$root@midascode:~/laravel/laradock/caddy# docker-compose up -d mysql caddy
1057-
```
1058-
View your Site in the Browser Securely Using HTTPS (https://yourdomain.com)
1059-
1060-
##### Note that Certificate will be Automatically Renew By Caddy
1061-
1062-
>References:
1063-
>
1064-
- [https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04)
1065-
- [https://www.digitalocean.com/products/one-click-apps/docker/](https://www.digitalocean.com/products/one-click-apps/docker/)
1066-
- [https://docs.docker.com/engine/installation/linux/ubuntulinux/](https://docs.docker.com/engine/installation/linux/ubuntulinux/)
1067-
- [https://docs.docker.com/compose/install/](https://docs.docker.com/compose/install/)
1068-
- [https://caddyserver.com/docs/automatic-https](https://caddyserver.com/docs/automatic-https)
1069-
- [https://caddyserver.com/docs/tls](https://caddyserver.com/docs/tls)
1070-
- [https://caddyserver.com/docs/caddyfile](https://caddyserver.com/docs/caddyfile)
1071-
1072-
1073-
866+
####[Full Giude Here](https://github.com/LaraDock/laradock/blob/master/_guides/digital_ocean.md)
1074867

1075868

1076869

@@ -1081,12 +874,11 @@ View your Site in the Browser Securely Using HTTPS (https://yourdomain.com)
1081874

1082875

1083876

877+
<br>
878+
<a name="Misc"></a>
1084879

1085880

1086881

1087-
<br>
1088-
<a name="Misc"></a>
1089-
### [Misc]
1090882

1091883

1092884
<br>
@@ -1239,7 +1031,7 @@ Moving from Docker Toolbox (VirtualBox) to Docker Native (for Mac/Windows). Requ
12391031

12401032
This little project was built by one man who has a full time job and many responsibilities, so if you like this project and you find that it needs a bug fix or support for new software or upgrade any container, or anything else.. Do not hesitate to contribute, you are more than welcome :)
12411033

1242-
#### Read our [Contribution Guidelines](https://github.com/LaraDock/laradock/blob/master/CONTRIBUTING.md)
1034+
#### Read our [Contribution Guidelines](https://github.com/LaraDock/laradock/blob/master/_guides/contributing.md)
12431035

12441036
<a name="Help"></a>
12451037
## Help & Questions
@@ -1258,6 +1050,7 @@ For special help with Docker and/or Laravel, you can schedule a live call with t
12581050

12591051
**Main Contributors:**
12601052

1053+
- [MidasCodeBreaker](https://github.com/midascodebreaker)
12611054
- [Larry Eitel (LarryEitel)](https://github.com/LarryEitel)
12621055
- [Suteepat (tianissimo)](https://github.com/tianissimo)
12631056
- [David (davidavz)](https://github.com/davidavz)

CONTRIBUTING.md renamed to _guides/contributing.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
2-
31
# Contributing to LaraDock
42

53
Your contribution is more than welcome. Let's keep LaraDock amazing.
@@ -139,4 +137,4 @@ from the main (upstream) repository:
139137

140138

141139
<br>
142-
### Happy Coding :)
140+
### Happy Coding :)

0 commit comments

Comments
 (0)