FAQ - Frequently Asked Questions

Answers to the most common questions

Menu

Theme

Toggle between light and dark mode

Language

Choose your preferred language

Font Size

Adjust text size for better readability

Content Width

Choose optimal width for your screen

Table of Contents

Show or hide the table of contents

Actions

More options coming soon...

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 (main or master)
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 ps to 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.yml exists
  • 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.yml is 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:alpine
  • node:18-alpine
  • python:3.11-slim
  • postgres: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
  1. Check this FAQ
  2. Review the documentation on zohrabi.cloud
  3. 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

Other pages