FAQ - Frequently Asked Questions
๐ Authentication and Access
๐ญ I didn't receive my credentials
Check your spam folder. If you still can't find the email, contact your instructor at Reza@zohrabi.fr.
๐ I forgot my password
Currently, you need to contact your instructor to reset your password. Send an email to Reza@zohrabi.fr with your username.
๐ My account is locked
After 3 failed login attempts, your account may be temporarily locked. Wait 15 minutes or contact your instructor.
๐ฆ Git and Repository
๐ฅ How do I clone my repository?
git clone https://git.zohrabi.cloud/your.name/workshop1.git
Replace your.name with your username and workshop1 with the desired workshop.
๐ซ I can't push to my repository
Check that:
- You are properly authenticated (correct username/password)
- You have write permissions on the repository
- You are on the correct branch (
mainormaster)
git remote -v # Check the URL
git branch # Check the branch
โ ๏ธ Error: "fatal: unable to access"
This error usually means a connection problem. Check:
- Your internet connection
- The repository URL is correct
- Your credentials are correct
๐ณ Docker and Containers
โ Docker Compose won't start
Check:
1. The syntax of your docker-compose.yml
2. Ports are not already in use
3. Images are correctly specified
# Check syntax
docker compose config
# See error logs
docker compose logs
๐ Error: "port is already allocated"
Another service is already using this port. Solutions:
- Change the port in
docker-compose.yml - Stop the service using the port
- Use
docker psto see active containers
๐งน How do I clean up Docker?
# Stop all containers
docker compose down
# Remove unused images
docker image prune -a
# Remove all volumes (WARNING: data loss)
docker volume prune
โ Automatic Grading
๐ The grading doesn't trigger
Check that:
- You have done
git push - The file
.gitea/workflows/correction.ymlexists - You haven't modified the workflow
Go to Actions on Gitea to see if the workflow has started.
0๏ธโฃ My grade is 0/100
Possible causes:
- Docker build failed
- The
docker-compose.ymlis invalid - Required services don't start
- Tests don't pass
Check the detailed report in the email to understand the error.
๐ง I didn't receive the email with my grade
Check:
- Your spam folder
- That the grading has finished (Actions tab)
- Your email address in Gitea (Settings > Profile)
If the problem persists after 30 minutes, contact your instructor.
๐ Can I submit multiple times?
Yes, but with a limit! You have 3 attempts per workshop by default. The best grade will be kept for the final evaluation.
If you need extra attempts, ask your instructor.
๐ Best Practices
๐ What project structure should I use?
Minimal structure:
my-project/
โโโ Dockerfile
โโโ docker-compose.yml
โโโ app/
โ โโโ (your files)
โโโ README.md
๐ณ Which Docker images should I use?
Prefer official images:
nginx:alpinenode:18-alpinepython:3.11-slimpostgres:15-alpine
Always specify a version/tag (not latest).
๐ How do I document my project?
Create a README.md with:
- Project title
- Description
- Technologies used
- Build and run instructions
- Author
๐ Debugging
๐ Where can I see my container logs?
# Real-time logs
docker compose logs -f
# Logs for a specific service
docker compose logs -f web
# Last 100 lines
docker compose logs --tail=100
๐ฅ๏ธ How do I enter a container?
# For a running container
docker compose exec web sh
# Or with bash if available
docker compose exec web bash
๐ My application doesn't respond
Check:
1. The container is running: docker compose ps
2. The logs: docker compose logs
3. Port mapping is correct
4. The firewall allows the port
๐ Grades and Evaluation
๐งฎ How is my grade calculated?
Each workshop has its own grading criteria. The grade is calculated as a percentage of passed tests.
For example, for Workshop 2 (Simple Web Server): - Dockerfile exists - Dockerfile uses nginx as base image - Dockerfile copies index.html to /usr/share/nginx/html - index.html exists - build.sh exists and is executable - run.sh exists and is executable
Check the test details in the correction logs.
โ๏ธ Can I contest my grade?
Yes. Send an email to Reza@zohrabi.fr with:
- Your username
- The relevant commit
- A detailed explanation
๐ Where can I view my grades?
Go to https://grades.zohrabi.cloud and log in with your Gitea credentials.
๐ Support
โ I can't solve my problem
- Check this FAQ
- Review the documentation on zohrabi.cloud
- Contact your instructor: Reza@zohrabi.fr
๐ Are services available 24/7?
Yes, all services (Gitea, Dashboard, Grading) are available 24/7.
In case of unavailability, a message will be displayed on the home page.
Question not listed? Contact Reza@zohrabi.fr